home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 006 / minicalc.arc / MINICALC.DOC < prev   
Text File  |  1986-04-26  |  12KB  |  220 lines
  1. DOCUMENTATION FOR MINICALC.BAS
  2.  
  3. MiniCalc gives the user an 11 by 22 matrix of cells to work with.  
  4. The layout of the matrix is similiar to that of the popular 
  5. spreadsheet applications with the rows labeled 1-22 and the 
  6. columns labeled A-K.  The program will work with one disk drive 
  7. and 48K with no problem.  It will also work with either the 
  8. monochrome adapter or the color monitor adapter.  It does need an 
  9. 80 column display.  This program was written for an Epson MX-80 
  10. printer, although most printers should work.
  11.  
  12. When the program is run, it comes up with the matrix on the 
  13. screen and the inverse video cursor in the top left corner, 
  14. position A01.  The cursor keys at the right of the keyboard move 
  15. the inverse video cursor through the matrix.  At the bottom of 
  16. the screen are two status indicators.  The bottom left indicator 
  17. tells the user whether the Caps Lock key is on or off.  This is 
  18. handy as the matrix locations must be entered in Caps.  The 
  19. bottom right indicator tells what mode the numeric keypad is 
  20. currently in.  If the cursor mode is active, it will display 
  21. Cursor.  If the number mode is active it will display Number.  
  22. when the program is first run, it initializes the Caps indicator 
  23. to Caps On and the Keypad indicator is set to Cursor.
  24.  
  25. At the top of the screen, the user will see the status line, 
  26. indicating the current cursor location and the assignment for 
  27. that cursor location.  At any particular cell in the matrix, you 
  28. have the option of entering a number, entering a label or 
  29. performing a command.  To enter a number, simply type in the 
  30. number and press return.  To enter a label, type in the label and 
  31. press return.  MiniCalc recognizes anything starting with a 
  32. number as a number and anything starting with a letter as a 
  33. label.  If you do not press return when entering a label, 
  34. MiniCalc will make that label temporary.
  35.  
  36. To perform a command, press the "/" key.  Then the status line 
  37. will show "Special Command (A,B,C,D,E,G,H,L,N,P,Q,R,S,T,>)?" 
  38. indicating the command options available to the user.  Pressing a 
  39. carriage return at this point will abort the special command 
  40. procedure.  To perform a command, simply enter the appropriate 
  41. command letter.  The commands are:
  42.  
  43. A - Average.  Allows the user to average a series of cells in a 
  44. row or column and put the result in another cell.  The format for 
  45. entering a cell location is "ann" where "a" is the column 
  46. coordinate (in caps) and "nn" is the row coordinate (always two 
  47. digits i.e. - A01).  In response to entering "/A" the status line 
  48. will be cleared and filled with "AVERAGE. Enter coordinates:".  
  49. This is the user's prompt to enter the range of coordinates for 
  50. the average, and the cell where the result will be placed.  For 
  51. example, say the values 1, 2 and 3 were in locations A01, B01 and 
  52. C01, respectively, and that you wanted to put the results in 
  53. location A03.  For the above prompt to enter the coordinates, the 
  54. user would enter "A01" and the system would acknowledge that with 
  55. ".." indicating you should enter the next coordinate.  You would 
  56. then enter "C01" and the third coordinate you would enter would 
  57. be "A03".  After all of this was entered, MiniCalc would write 
  58. the equation for this average at location A03, make that 
  59. calculation and then move the cursor to that location.  The 
  60. status line would read "A03 = 2  A01+B01+C01/3".  Thus the 
  61. coordinates asked for are the beginning and ending range of 
  62. numbers to be averaged in a row or column followed by the 
  63. location where the result should be placed.
  64.  
  65. B - Blank.  This allows the user to erase whatever is in the 
  66. current cursor location.  For example, if the current cursor 
  67. location is A01 and has the value 250 in it and the user presses 
  68. "/B", then A01 will be erased and the status line will show A01 
  69. assigned a value of zero.
  70.  
  71. C - Compute.  This allows the user to make a computation between 
  72. two numbers and store the result at a third location.  In 
  73. response to "/C" the system will clear the status line and 
  74. display "COMPUTE. Function (+,-,*,/) ?".  This is asking which 
  75. operation is to be performed on the two locations.  After 
  76. selecting one of the four operations, the system will display 
  77. "Enter Coordinates:", asking for the two locations to perform the 
  78. operation on and the location to store the result.  For example, 
  79. if A01 had 1 in it and B01 had 2 in it and we wanted to add these 
  80. two locations together and store the result in A03 then in 
  81. response to the "Function" prompt, we would press "+" and then 
  82. enter "A01", "B01" and "A03" in response to the MiniCalc prompts 
  83. in the same manner the Average command worked.
  84.  
  85. D - Delete.  Allows the user to delete a series of locations in 
  86. either a row or a column.  To use this command, you would enter 
  87. "/D" and Minicalc would respond with "DELETE. Enter 
  88. Coordinates:".  In this case, you would enter the starting and 
  89. ending location in the series to be deleted and MiniCalc would 
  90. then erase those locations.
  91.  
  92. E - Equation.  This command has two options.  The first allows 
  93. the user to enter an equation for the current cursor location.  
  94. The equation must be simple, allowing only the four operators to 
  95. be used in the equation.  The equation will be evaluated from 
  96. left to right.  The second option tells MiniCalc to compute all 
  97. of the equations in the matrix.  This is the only method used by 
  98. MiniCalc to make the calculations based on the equations in the 
  99. current matrix.  An example of entering an equation for a 
  100. particular location:  The cursor is at location A03 and we want 
  101. to put the average of locations A01 and B01 plus whatever is in 
  102. C01 at the current cursor location.  In response to the "Equation 
  103. or Compute" prompt, we would press "E" and then enter 
  104. "A01+B01/2+C01" and press return.  This would enter that equation 
  105. for location A03, although it would not automatically compute the 
  106. value.  The "Compute" option would perform that function.
  107.  
  108. G - Graph.  The graphing function allows the user to create a bar 
  109. graph for a particular row or column.  This graph can then be 
  110. dumped to the printer.  In response to "/G" the system would 
  111. clear the screen and ask whether a column or a row was to be 
  112. graphed (C or R).  If the user selected "R", for example, then 
  113. MiniCalc would ask for the row (1-22) to be plotted.  For the 
  114. first row, the user would enter "01".  Then the user would see 
  115. the bar graph for row 01 and would be given the option of dumping 
  116. the graph on the printer or going to the MiniPlot Menu.  The 
  117. MiniPlot Menu gives the user the option of quitting, plotting 
  118. another row or column or returning to MiniCalc.
  119.  
  120. H - Help.  The help function displays a brief one-line 
  121. description of the command in question on the status line.  for 
  122. example, in response to "/H" MiniCalc would prompt for the 
  123. command in question.  If the user selected "A", MiniCalc would 
  124. give a one-line description of the Average command.
  125.  
  126. L - Load.  This function allows the user to load a matrix from 
  127. the diskette that has been saved with the Save command.  In 
  128. response to "/L" MiniCalc will ask for the filespec of the file 
  129. to be loaded.  At this point, pressing return will abort the load 
  130. sequence and take the user back to MiniCalc.  If a drive is not 
  131. specified, the MiniCalc will look for the file on the current 
  132. drive.  For example, to load a file "SALES.DAT" from drive B, the 
  133. user would enter "B:SALES.DAT" for the filespec.  Upon entering a 
  134. filespec and pressing return, MiniCalc will prompt the user to 
  135. ready the drive that is to contain "SALES.DAT" and press return.  
  136. At this point MiniCalc will load the file, make the appropriate 
  137. calculations and display them on the screen.
  138.  
  139. N - New.  Allows the user to start MiniCalc over, as in entering 
  140. "RUN" in BASIC.  This clears the entire MiniCalc matrix, so any 
  141. data worth saving should be saved prior to execution of this 
  142. command.
  143.  
  144. P - Print.  Takes the current MiniCalc Matrix and dumps it to the 
  145. printer.  The printer should be readied prior to executing this 
  146. command.
  147.  
  148. Q - Quit.  Exits the MiniCalc program, giving appropriate 
  149. credits.  Any data not saved from the MiniCalc matrix will be 
  150. lost when this command is executed.
  151.  
  152. R - Replicate.  A function that allows the user to generate a 
  153. series of numbers based on one of the locations in the MiniCalc 
  154. matrix and a constant.  For example, if the user wanted the 
  155. numbers 1 through 22 in locations A01 through A22 then the user 
  156. would move to location A01, blank out the previous contents and 
  157. enter the number 1 there.  Then use the "/R" command to create 
  158. the rest of the numbers by adding one to to location A01.  In 
  159. response to the "/R" command MiniCalc would respond with 
  160. "REPLICATE.  Function (+,-,*,/) ?".  The user would enter the 
  161. operation to be performed on each location ("+" in this case) and 
  162. MiniCalc would respond with "Value?".  We are adding one, so "1" 
  163. and return would be the appropriate response.  MiniCalc would 
  164. then prompt with "Enter coordinates:" and the user would respond 
  165. with "A01", "A02" and "A22", telling MiniCalc to use location A01 
  166. as the source for the operation and to perform the operation on 
  167. locations A02 through A22.  MiniCalc would perform the 
  168. calculations and move the cursor down to A22, the status line 
  169. showing "A22 = 22  A21+1".  In the equation shown on the status 
  170. line, the location will always be the previous location, the 
  171. operation will be the operation the user entered ("+" in this 
  172. case), and the constant will be the value the user entered ("1" 
  173. in this case).
  174.  
  175. S - Save.  This function allows the user to save a MiniCalc 
  176. matrix to diskette.  In response to "/S" MiniCalc will ask for 
  177. the filespec of the file to be saved.  At this point, pressing 
  178. return will abort the save sequence and take the user back to 
  179. MiniCalc.  If a drive is not specified, the MiniCalc will put the 
  180. file on the current drive.  For example, to save the current 
  181. matrix to a file "SALES.DAT" on drive B, the user would enter 
  182. "B:SALES.DAT" for the filespec.  Upon entering a filespec and 
  183. pressing return, MiniCalc will prompt the user to ready the drive 
  184. that is to contain "SALES.DAT" and press return.  At this point 
  185. MiniCalc will save the file to the appropriate drive and return 
  186. to MiniCalc.  The Load command is used to load a file from 
  187. diskette.
  188.  
  189. T - Total.  The Total command allows the user to sum a series of 
  190. locations in a row or column and store the result in a particular 
  191. location.  In response to "/T" MiniCalc will display "TOTAL.  
  192. Enter Coordinates:".  MiniCalc is looking for the start of the 
  193. range to be summed, to end of the range to be summed and the 
  194. location to store the results.  For example, if the user had 
  195. sales figures in positions A02 through A11 and wanted to put the 
  196. sum of those sales figures in position K03, the user would enter 
  197. the locations "A02", "A11" and K03.  MiniCalc would move to 
  198. location K03 and display the sum and the equation to create that 
  199. sum.
  200.  
  201. > - Goto.  Allows the user to jump to any location on the 
  202. MiniCalc matrix.  This command can be executed directly from the 
  203. MiniCalc matrix by entering ">" or can be executed with the slash 
  204. command by entering "/>".  MiniCalc will respond by prompting for 
  205. the location to move to.  The format for the location is "ann" 
  206. where "a" is a letter between "A" and "K" and "nn" is a number 
  207. between "01" and "22".  This allows the user quick access to any 
  208. location on the MiniCalc matrix.
  209.  
  210. MiniCalc recognizes equations and labels.  When a matrix is saved 
  211. to diskette, all the values, equations and labels are stored as 
  212. well.  For a label to be a "permanent" label, the carriage return 
  213. must be pressed after entering the label.  Otherwise the label is 
  214. temporary and will not be stored.
  215.  
  216. In the listing, the lowercase i with an arrow over the top of it 
  217. has a decimal value of 140.  This functions as a form feed for 
  218. the Epson MX80 when the program is listed on the printer.
  219.  
  220.